home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The Original Shareware 1.1
/
The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso
/
4
/
slicbbs5.exe
/
lha
/
SLICKBBS.DOC
< prev
next >
Wrap
Text File
|
1990-03-06
|
41KB
|
749 lines
S L I C K B U L L E T I N B O A R D
by Simple Software Company
P.O.B. 8184
N. O., La., 70182
(504) 288-6550
03/10/1990 SBBS V.4.5 New Release, More Features
ACKNOWLEDGEMENTS:
Terry Tekippe, Ph.D., Notre Dame Seminary, my assembler instructor,
Svengali, and overall guiding light.
VARIOUS UN-NAMED SYSOPS whose support, suggestions, ideas and
contributions cumulatively helped mold the
final product.
The Guys at SemWare for creating a programmer's editor that
home of "Q"edit almost writes the code for you.
REGISTRATION POLICY:
The only files not provided (until registration) are the source code files
themselves. SBBS is available without the source code for half price. The
fully registered version, with source code, is $59.00. Without source code
it's 29.00. If registered without source code we will provide you with the
latest version, customized with your BBS's name. With the source code
registration you will be licensed to alter at will with NO restrictions
relative to your private non-commercial use. In either case, you will
have full telephone support (your toll expense), and any further upgrades
when they are available for never more than 25% of the current Retail
prices. Bug fixes will always be NO CHARGE.
If you wish to see this BBS in action, CALL 504-283-9785. Unfortunately
the phone lines are extremly noisy and of poor quality, so although SBBS
supports 2400 baud, you will likely do better with 1200. In any case,
our Support BBS, Host Line, running V 4.4 of SBBS, is on 24 hours a day
seven days a week at 300/1200/2400 8N1.
FORWORD:
My intention in writing a bulletin board was not to re-invent the wheel, but
rather to provide a flexible product that provides the following advantages.
#1. A basic BBS kernel that on its own provides most of the services that
are popular with most users of on-line systems. #2. A high level language
that is MORE likely to be understood by most computer aficianados.
#3. Providing *** ALL *** source code with NO hold backs, which is fully
commented so even the novice purchaser can understand what's going on.
#4. Using a language that will allow the user to purchase a compiler for
under $50. #5. Provide the basis for a new or experienced Sysop to once
and for all have total control over over his operation with the ability
to customize or change at will.
Because it is next to impossible to actually re-invent the wheel, you
will no doubt find a great deal of similiarity to the operational style
of SBBS in comparison to many other good BBS products. And you should,
because I took the best features of them all in designing the style,
feel and elegance of SBBS.
Turbo Basic was picked for this unique and rather ambitious
project. Sure, Turbo Basic is no longer under continuing development
by Borland and Quick Basic by Micro Soft still is, but Turbo Basic as
it stands does everything that needs to be done as you will soon see.
There are a number of operations that are unquestionably best done in
machine specific code. These portions therefore are included in TB $INLINE
and CALL INTERRUPT format. There ARE NO mysterious OBJ files that are
required to be linked, but come with NO SOURCE code. You will have everything
you need to COMPLETELY rewrite the entire BBS if you desire to.
FEATURES:
SBBS supports only COM1 and COM2 from 300 to 2400 baud at 8N1. Although
restrictive in some cases, I have found this to take care of 95% of most
users' hardware needs. The Shareware Version comes hard-coded for COM1 at
2400 baud. Registered versions without source code will be shipped to
your specifications within the above limits. Those requesting source code
registration will of course be able to alter ANY parameters at will.
See the end of this document for some modem hints and suggestions.
SBBS allows any number of message conferences, security levels, bulletins,
and users. Both private and public messages are supported. SBBS provides
for both a master and/or master and assistant sysop. Uploading and Downloading
of Files is supported by using the famous DSZ protocol engine provided by
OMEN Tech. also available from the BBS where you obtained SBBS. This engine
provides for the three most common file transfer protocols. Xmodem (in
all its variant forms), Ymodem Batch and the highly recommended Zmodem
with its fancy error checking, crash recovery, and packet resizing ability.
Various Door Utilities can be supported such as ZIP viewers and text file
readers. The code as written supports just one door but can easily be modified
to accomodate as many as you want. Doors are Batch operated and care should
be taken to insure that any utility you desire to run monitors the Modem
MSR byte for carrier detect at bit position 7. Most well-designed Doors do it.
The Sysop Menu allows the Master Sysop to Drop to DOS from a remote
terminal. SBBS incorporates its own Hot Boot code in such a way that if the
system is idle at 2 minutes 45 seconds past MidNight it will initiate a
System re-boot to reset your DOS time from your internal battery clock. If
someone happens to be on line at that time, the re-boot is delayed until
after they logoff. SBBS will also reset immediately if for any reason
carrier is lost during a logon. SBBS also monitors idle time at the remote
keyboard. If no activity is detected within 3 minutes, again SBBS will
Logoff and reset. A warning is displayed after 2 minutes. Any keystroke
automatically resets the counter.
This archive should contain the following files, and/or they will be
created by the configure engine, SLICKCFG.EXE. Those marked with a
star (*) are generated by the SLICKCFG. Files marked by a pound
symbol (#) are created and/or updated by the runtime file, SLICKBBS.EXE.
SLICKBBS EXE The Main BBS Program complied with Turbo Basic Ver 1.1
SLICKBUL DAT# The bulletin database reference. Ascii Sequential File
SLICKCFG DAT* MAIN BBS configuration file created by SLICKCFG.EXE*
SLICKCON DAT* The conference database. Ascii Sequential File
SLICKLOG DAT* Record of daily logons, updated by BBS, deleted nightly.
SLICKMSG DAT* Message database containing text of mail
SLICKMSG HDR* Message pointer database. Random access file
SLICKUSR HDR* User Database. Random access file
SLICKUSR REF# User Name/Number Ascii file (pointer to SLICKUSR.HDR)
SLICKMOD CFG* New Modem Configure file (simple ascii)
NEWUSER LOG# Ascii text record of all new logons.
ACTIVITY LOG# Accii text record of all activity of BBS
SIGNON TXT Text File you may customize with your own Logon Message
WELCOME TXT@ Text File can be anything you want, Notices, Alerts, etc.
NEWUSER TXT@ Text File displayed to New Users ONLY. You customize
TODAY TXT Text File displayed (if found) to every logon
BBSLIST TXT@ Text File of whatever BBS's you wish to promote (called/Main)
SYSINFO TXT@ Text File describing your BBS operation called from Main Menu
MENU TXT@ Text File of Main Menu
FILEMENU TXT@ Text File of File Menu
FILESDIR TXT Text File of files available for DownLoad on your system.
JOKES TXT Text File collection of witty sayings to be shone randomly
SIGNOFF TXT@ Text File of your logoff message (again, anything you want)
SYSMENU TXT@ Text File of Sysop Menu
(samples of all Text Displays are Included)
The files with the @ to the right all have their ANSI COLOR Graphic counter-
parts located in a separate archive called ANSI.ZIP. They must be located
in a separate directory by themselves, pointed to via the SLICKCFG.DAT file.
If a logon selects Color, SBBS will then automatically point to the correct
directory and the ANSI Color files will be displayed. NOTE: We highly
recommend an ANSI Editor called TheDraw (available on almost all good BBS's)
to edit these files. The samples included were created on TheDraw.
PLEASE NOTE: The ANSI display files HAVE THE SAME FILE NAMES as their plain
Ascii counterparts. DO NOT unzip the archive ANSI.ZIP in the same directory
as the mono versions as there is a chance you may overwrite them even though
pkunzip will warn you ! Its best to move this file to the directory where
it will reside and upzip it there !
GETTING STARTED:
It is highly recommended that you load SBBS via your autoexec.bat file.
In this way, when SBBS does a warm boot at midnight your board will
automatically return on line.
You will need to do a little planning ahead and prepare to answer the
following questions. How many users do you expect to support? (this can
always change later). How much time are you going to allow your users to
logon on a per logon basis? What will be the size of your message support
system? What will be the security level of new logons? How many conferences
and at what security levels do you wish to operate?
Before anything else is said, a very important element is the FIRST Logon.
This MUST be YOU if your intentions are to be the SYStem OPerator (Sysop).
The FIRST Logon (either locally at the console or via a remote) is, by
default, given the highest access (level 6000/Master Sysop). Everyone from
then on is assigned the level put into the configuration file (SLICKCFG.DAT).
Then it is up to either the assistant sysops (if the Master creates any at
level 5000) or the Master himself to upgrade ANY user higher than the Logon
default of 1000. It might also be noted that the user reference file called
SLICKUSR.REF is created automatically on first logon and updated from then
on as new users logon. ALL files created by SLICKCFG.EXE must also be
in the runtime (SD) slick directory, otherwise SBBS will fail to load and
run.
Let's begin by understanding a few numbers based on experience. I suggest
you begin with a database for 200 users and 200 messages (again, this
can always change). Most video boards support 25 lines of screen text and
most users generally leave messages under 100 words. So, my suggestion is
to set the number of message lines to 20. Since each line is 80 characters
long this will produce a file of 320K (80X20X200) that will nicely backup
on a standard floppy if you wish to save it (and if you run a BBS, you
should backup everything). One of the big problems with any BBS is the
pile up of old traffic (messages) in the database. To help with this
problem, SBBS automatically marks any personal traffic that has been
read by the receiver for deletion. Then, depending on need, it's only
necessary to enter the Sysop menu and hit "D" to remove them. A detailed expla-
nation of ALL Main menu and Sysop menu keys will follow. But, REMEMBER, with
the source code you have total control of any of this. Also, a 20-line
message eliminates the need to have an elaborate scrolling method (which
few BBS have anyway) as the sender can always view his entire message on
just one screen length. I have incorporated some miminimal editing capability
into the code so corrections can be made before saving. You can go ape
with security levels but I suggest a simple system. 1000 for new logons,
2000 for regular users, 3000/4000 for SIGS, 5000 for assistant sysops,
and 6000 for you the master Sysop. Unless you register for the source
code, you won't have any control over these defaults anyway; but the numbers
work out nicely. By default, 2000 is required for File access through
the Main Menu. A simple registration policy is best without any begging
or threats of banishment if users dont upload. SBBS asks by default for
the user's real name and phone number. It's my personal policy to verify
the phone number and then give them regular access. Thirty percent will
leave you a thank you note, the rest expect access as if it were a
right but you will soon learn that Sysoping is a one-way giving experience
only. SBBS will generate a NEWUSER.LOG and record all new users and
their phone numbers to make upgrading relatively easy. The Sysop has
easy access to this file via his Menu.
Again, obeying the KISS formula, I suggest keeping the number
of Conference Areas to just a few. Five or six seems to work well,
with Titles like Public Forum (1000) (NOTE: Private Mail is covered by
default as Conference zero (0), and mail addressed to Sysop is
defaulted to the name of the first logon (the Sysop). Then something
like: Swap Shop (1000), Buy & Sell (1000) all accessible to New Logons
on first call. Then perhaps a regular user conference like Local
Happenings: (2000), and or Hints & Tips: (2000). If you wish, you can
support SIG's (special interest groups) like Programmer's Corner:
(3000) and/or non-computer interest like Citizens Against Drugs:
(3000) etc.
When you run SLICKCFG.EXE, a number of questions will be asked. First,
What com port are you using, COM1: or COM2:, (enter it that way). What
is the max baud of your modem, 300, 1200, or 2400. What pariety, What
Databits, What stopbit, What modem init string to use? After these
questions are correctly answered it will then proceed to the next questions.
How many conferences do you wish to support? Remember, you can always
add on more, so start small. Second question, how many lines per question?
20 is suggested. How many messages? I suggest 200 to start. In what directory
will your downloads (those received from your users) be stored ? I suggest
setting up a directory off the root called C:\BBS, then create C:\BBS\DOWN for
this location. Next question wants the same information for the directory
in which you intend to store files you are making available to your users. This
can be C:\BBS\UPLOAD. Next, where will the main files be located? Of
course this will be C:\BBS. (NOTE: The mono text graphic files will
reside here as well, i.e. Menus,Bulletin and display files.) Then, where
will you keep the COLOR ANSI files? I suggest using C:\BBS\ANSI. Also
you will need a directory called C:\BBS\TEMP if you use the utility
AVIEWCOM. The identical display Ansi files should be placed here. The
next question is, what security level will be assigned new users? I
suggest using 1000. How many users? I suggest 200 to start. Finally, and
this like everything else is a judgment call, how many minutes will
you allow each logon ? I suggest between 60 and 120 minutes. REMEMBER,
any of these items can be altered later on. A sample of the file created
by this utility is included down below along with all other data files
used by SBBS.
This Utility will also generate several other files SBBS looks for at
runtime. One is SLICKLOG.DAT and the other is SLICKBUL.DAT. The first
must be found at runtime. The second can be dynamically created via the
Sysops utilities later on; but, to illustrate a good idea, one is made
for you which incorporates a master bulletin of all other bulletins
as bulletin #1. The Title "Master Bulletin" and file name MAST.BUL with
a security level of 1000 is suggested. The first "sample menu" below is
that of MAST.BULL containing a descriptive list of 20 other bulletins.
LOGON:
Once you have created all the necessary directories, placed the proper
files therein, and customized whatever display files you need, the first
test will be to boot SLICKBBS.EXE. For now, just move to SBBS's parent
directory and type the name at the C> prompt. If all necessary files are
in place, SBBS will come into action with a message appearing in the upper
left corner of the screen. SBBS will say it is Waiting for a Call.....
You will also note the two keys necessary to either LogOn Locally at the
console or terminate the program. The Esc key will allow a local log and
the "+" key will terminate the program. NOTE: A local logon, for simple
security reasons, will not automatically give Sysop access. In fact, to
assist in learning what the user sees, a Local logon will run you through
the same exact sequence of events as if it were a remote logon. REMEMBER,
the FIRST LOGON controls WHO will be MASTER SYSOP. If SBBS fails to reach
the runtime mode, more than likely the reason is due to its inability to
locate one or more of its necessary support files. An error code of 52,53
or 63 or 64 will indicate this. Since there are only a handful of support
files, I saw no reason to include code (it takes up more space and runtime)
that would point to the specific missing file, although this could easily
be added if you wanted it.
Once you have succeded in doing the first logon, you may wish to leave the
first piece of mail to ALL, welcoming everyone to enjoy your new BBS. You
can also run through all the Main Menu options, testing every feature to
insure all other display files are working, etc. Unfortunately, when a
User selects color, the local console will not react to the ANSI escape
codes to trigger the video card into color. The Remote user will, however,
receive correctly. Again, to keep speed to a max, I avoided the DOS
function Int 21, direct write to console function. As an observer, you
have little use for seeing ANSI color anyway when a remote logon occurs.
Again, if anyone wants this feature, and doesn't mind the slowdown, I
will be happy to show them how to do it.
╔════════════════════╡ Host Line Bulletin Menu ╞══════════════════════════╗
║ ║
║ # 1 - This Menu of ALL Bulletins # 12 - Universal BBS Rules ║
║ # 2 - How to USE SBBS facilities # 13 - Mensa Mind Benders ║
║ # 3 - Location of Area SIG Meetings # 14 - Learn to Fly ║
║ # 4 - Advertisement from SSC # 15 - List of N.O. BBS's ║
║ # 5 - News on Slick Terminal # 16 - How to setup for ANSI Color║
║ # 6 - Area GrapeVine (Gossip) # 17 - Defeat Call Waiting ║
║ # 7 - ZIP info ! # 18 - SBBS Protocols ║
║ # 8 - Bargain Shoppers Memo # 19 - From the Mind of a SYSOP ║
║ # 9 - Sysop's File Reviews # 20 - Reserved ║
║ # 10 - SSC Shareware Products NOTE: Some Bulletins require access ║
║ # 11 - New Users Read this FIRST over 1000; ie REG,SIG,RSWU etc. ║
╚══════════════════════════════════════════════════════════════════════════╝
Mono Ansi
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
▓▓ ▓▓
▓▓ ** M A I N M E N U ** ▓▓
▓▓ ▓▓
▓▓ X = Expert Menu Mode B = Bulletin Section ▓▓
▓▓ ? = ReDisplay Menu F = Files Menu (Reg Only) ▓▓
▓▓ E = Enter Message U = User List of SBBS ▓▓
▓▓ R = Read Messages W = Welcome message ▓▓
▓▓ D = Delete Message I = Information on SBBS ▓▓
▓▓ Y = User Status M = Message Statistics ▓▓
▓▓ P = Page the Sysop A = Alter Password/Phone ▓▓
▓▓ N = New Messages G = Goodbye, LogOff ▓▓
▓▓ L = Show Today's Log S = Scan Message Titles ▓▓
▓▓ O = Other AREA BBS's C = Toggle ANSI Color ▓▓
▓▓ + = Sysop's Utilities * = Reserved ▓▓
▓▓ ▓▓
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
Most of these selections are rather obvious but some not so. The
Menu comes in two forms, the full file menu (as shone above, which
can be edited easily with any text editor) and the abbreviated
menu which always appears after each regular text menu. Even the
abbreviated menu can be changed via the source code. The (X)pert
mode simply disables the text menu display and saves a few seconds
of toll time for the experienced user. Even in the (X)pert mode,
a simple question mark (?) will redisplay the correct menu. The
user has two options for reading his new mail, at logon or later
from the main menu via the (N)ew key. The (L)og key shows all
users who have been on since midnight. The (O)ther key displays
a simple ASCII text file you can create and modify at will to
promote your buddies BBS's as well. The (+) key allows access
to the Sysop Menu (providing the user has a level of 5000 or
greater). The code is written to make a record of any non-
authorized uses of that key in the activity log. I am not sure
what it suggests when a non-authorized user attempts to gain
access to the Sysops utilities, but it's fun to notice who does
and who doesn't. The (F)iles selection is only functional to
users with level 2000 or above. The Sysop must approve and set
this additional level of access from his utilities. The (U)ser
list will display ALL or some or one user that you may be
interested in. The (W)elcome key simply repeats a few of the
messages from original Logon. The (I)nfo key again displays a
basic text file you can create to explain all about the purpose
and goals of your BBS. The (M)essage Stats key gives just that,
information on the messages presently in the message base.
The (A)lter key allows users to change their passwords or
phone numbers. The (S)can key gives a quick run down of the
flavor of messages in the system. The (C)olor key simply toggles
the directories that hold either the Mono or ANSI Color Text &
Menu Files. The (G)oodby key is for signing off.
Mono Version
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
█ █
█ *** S Y S O P' S M E N U *** █
█ █
█ R = Return to BBS A = Re-Alphabetize User List █
█ D = Remove Deleted Messages K = Kill a Bulletin █
█ L = Delete Daily Log C = Edit Conferences █
█ M = Edit Message Header O = Slash OLD users █
█ ? = This Menu E = Edit Bulletin Headers █
█ U = Edit User F = Toggle Linefeeds █
█ B = Add a New Bulletin T = Trash Old Messages █
█ $ = Edit File Dir: S = Shell to DOS █
█ X = Toggle Auto Timer V = View DIR (Lcl Cons only) █
█ N = New User Log Z = Zap New User Log █
█ * = Read Activity Log # = Kill Activity Log █
█ █
█ * <F1 = Sysop at Console> * <F2 = Chat with User > █
█ * <F3 = Toggle Linefeeds> * <F7 = End Chat > █
█ * <F9 = Shut BBS Down: > * <F10= Log Off Violator> █
█ * <F4 = Forced Chat > [* From Local Console Only ] █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
The (R)eturn key brings you back to the Main menu. The (D)elete key
removes any messages marked for deletion by virtue of either having
been read by the receiver or deleted by the originator. The (L)og
key allows you to dump the Daily Logon record and reset it manually.
This is done automatically every night after midnight. The (M)essage
edit key allows editing of the content of the SLICKMSG.HDR file.
The (U)ser edit key is the most active as it is from here you will
upgrade your users from the default logon level of 1000 to that of
regular user level 2000. The (B)ulletin key allows you to add new
bulletins to your available list. All bulletin files should be
standard Ascii text files with the suggested extension of .BUL
The (E)dit bulletin key is also usful for altering some items.
You may also set the required security level for each bulletin as
well as enter a Title. The dollar sign key ($) allows line editing
of the FILESDIR.TXT so you may change as required with new additions
or deletions. The (X) key disables the auto timer annunciator.
The (N)ew key displays any new users since last reset, and the
(Z)ap key kills and restarts the log again. The (A)lpha key is a
seldom used bubble-sort utility for re-alphabetizing the user ref
file, SLICKUSR.REF, in case it ever gets disorganized. The (K)ill
key allows you to remove old bulletins. The (C)onference key is
for editing the SLICKCON.DAT conference data file. The (O)ld
user key is for setting a cutoff point for users that have not
logged on within so many days, months, etc., and for removing them.
The (F)orce linefeeds toggles the LF on or off. Most systems
require each line to be terminated with a Carriage Return followed
by a Line Feed (CHR$(13) & CHR$(10)) and this is the default. But,
if you need to eliminate the LF, this toggle will do it.
The (T)rash old messages key is useful for marking ALL messages for
deletion ON or BEFORE a certain date. Messages tend to build up
quickly and few are ever worth keeping for reference. The (S)hell
key allows the Master Sysop (only) to access DOS directly from a
remote. The (V)iew key allows the Master Sysop to basically get
a directory display of the default when in local mode. The "*"
key will dump the activity log to screen and the "#" key will
delete it from disk.
When at the local console, the F2 and F7 are used to start and
end Chat mode with a user. F10 can be used to start an immediate
LogOff of an undesirable user. (The kind who like to attempt
crashes of your system). F4 now provides a "Bust in" forced Chat
in case the logon is in the middle of code the F2 key cant penetrate.
Mono Version
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
▓▓ ▓▓
▓▓ L = List Files Directory ▓▓
▓▓ D = DownLoad File(s) ▓▓
▓▓ U = UpLoad File ▓▓
▓▓ R = Read a .TXT File (ascii) ▓▓
▓▓ Q = Quit to Main Menu ▓▓
▓▓ V = View ZIP content (if avail) ▓▓
▓▓ G = Good-Bye/LogOff ▓▓
▓▓ ? = Re-Show this Menu ▓▓
▓▓ ▓▓
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
The (L)ist key displays the FILESDIR.TXT file which is where you
will be keeping a record of your available files. I guess if there
is any section that has a lot of room for expansion it is here.
Services here are admittedly bare bones. There is no elaborate
file database for catogorizing files. Everything is in one basic
directory seen via the filesdir.txt. The novelty here is that
you can use any utility like PCTOOLS to re-sort your directory
(by date, decending....recommended) then do a "DIR > FILESDIR.TXT"
command at DOS to create your updated file. It's that simple for
now. Users are getting more sophisticated every day and the good
ones will usually download your list first to get a record of
your goodies, then simply download when they need to.
The (D)ownload feature supports batch Zmodem and allows the user
to grab up to nine files at one time. Also, Xmodem/Ymodem and
Ymodem/Batch are also available. The (U)pload feature allows
only SINGLE file transmission to facilitate giving a text
description of each contribution. SBBS will mark all NEW
Uploads with a (*) to clue the other users its not yet available
for download. This requires the Sysop to move the file
physically from one directory to another and remove the "*".
It's also a good idea for the Sysop to check the files he
receives before making them available to his users.
The (V)iew utility (AVIEWCOM highly suggested) is a very clever
utility for allowing three MAJOR operations. One: The viewing or
reading of any documentation file within an archive. Two: The
viewing of the contents of the archive itself, and Three: The
Downloading of any particular file within an archive. There are
many of these utilities around, but I suggest you register this
one in particular with the author.
A new feature has been added with the release of Version 4.5. Now
you can include ascii text files in your directory that the logon
can read (send to console) without having to download. This is a
feature that seems to be very popular lately, sort of a lazy mans
message and bulletin mode. I think the reason is obvious, all logons
immediately jump to the files department -- always passing up the
regular mail and bulletin sections. Therefor, to help get information
quickly to the users, Sysops are condoning this practice more
often than not.
****************************************************************************
SAMPLE of New Modem Configure File
SLICKMOD.CFG
COM1:
1200
N
8
1
CS2000
DS2000
ATH0M1V0&C1&D2S0=1S2=128
****************************************************************************
DROPDOS BAT Batch File to allow Sysop Drop to DOS.
CTTY COM1: {Three line content of dropdos.bat; note: Command.Com must
COMMAND.COM be in either the path or default directory}
CTTY CON
****************************************************************************
This information valid for version AVIEW34.ZIP Only!
DOOR1 BAT Sample Batch for running a DOOR. In this case, it is called
via the Files menu for manipulating the content of archives.
AVIEWCOM {content-just one line in this case} NOTE: We highly
recommend this shareware utility called AVIEWCOM.COM
for ZIP content viewing, text & doc displaying and
downloading. Since this and a large number of other
door utilities reset various com registers, SBBS
will automatically reset the modem back to the original
references (before door activation) after completion.
Another reason for buying AVIEWCOM is it also uses the
Omen DSZ engine for file transfers.
*AVIEWCOM CNF configuration file {comes with their package}
AVIEWCOM EXE utility itself ""
AVIEWCOM LOG dynamically created by runtime program.
*Sample content of AVIEWCOM.CNF for proper operation with SBBS
===============================
#SEARCH
#PATHS
C:\BBS ;main directory of SBBS and location of AVIEWCOM
#PORT
COM1 ;port, assummed to be COM1
;#VIDEO
;ANSI
#TEMPORARY
C:\BBS\TEMP ;temp directory for pkunzip to do its thing
#EXTRACTOR
PKUNZIP ;archive engine
===============================
This information valid for version AVIEW37.ZIP Only!
CONTENT of AVIEWCOM.CFN
#search
#paths
c:\modem\upload
CONTENT OF DOOR1.BAT
AVIEWCOM * COM1 -a2 -c -e4 -l -pC:\MODEM\TEMP -t30
****************************************************************************
Sample Bulletin names and possible content descriptions.
BULLMENU BUL Description of All Bulletins
ANSI BUL How to install ANSI NOBBS BUL List of Local BBS's
ANSIDEMO BUL ANSI Demo File PROTOCOL BUL Explanation of Protocols
BBSRULES BUL Rules of your BBS Etc. Etc.
BEST BUL Shareware Reviews
CALLWAIT BUL Disable Call Wait
GRAPE BUL Area GrapVine Gossip
MINDGAME BUL Word Games
NEWUSER BUL Help stuff for new users
*****************************************************************************
CONTENT of SLICKCFG.DAT, generated by SLICKCFG.EXE (sample)
Content Description Variable
_____________________________________________________________________________
5 Number of Conferences you decided on [NC]
20 Maximum Number of Lines per message [MAXLINE]
200 Maximum Number of Messages desired [MAXMESS]
1000 Sign On Security Level (1000 is suggested) [SEC]
200 Total Number of Users you will configure for [MAXUSER]
120 Total Number of Minutes allowed on per Logon [MAXTIME]
C:\BBS\DOWN DownLoad Directory (recv from user ) [DL$]
C:\BBS\UPLOAD UpLoad Directory (avail to users ) [UL$]
C:\BBS DIR of General Files (Slick Directory) [SD$]
C:\BBS\ANSI DIR of ANSI Files (Slick ANSI Menu) [CD$]
1 Total Messages Handled ( starts with 1 ) [REF]
1 Total Logons todate ( starts with 1 ) [CNUM]
{ $ denotes String variable, numeric type without }
*****************************************************************************
SLICKCON.DAT
Sample Content Array used Description
_________________________________________________________________________
Public Comments: -------> CONF$() Conference Title
1000 ------------------> CONF() Security Required
Hackers'Conference:
2000
Buy/Sell/Swap:
2000
Request Line:
1000
Bay Area SIG:
3000
CONF$(0) always = "Private Mail"
C(NC) conf.pointer
*****************************************************************************
SLICKUSR.HDR 76 byte records, 8 Fields
FIELD Description Variable Field size
____________________________________________________________________________
User Password UP1$,UP$ 10 bytes (characters)
User Name (full) UN1$,UN$ 30 bytes
User Phone Home UPH1$,UPH$ 12 bytes
Mail Reference ULR$ 2 bytes (integer) [total msg on sys]
Last Date of Logon UDL1$,UDL$ 10 bytes
Time of Last Logon UTL1$ 8 bytes
User Security Level USL$ 2 bytes (integer)
Mail Waiting UNW$ 2 bytes (integer)
*****************************************************************************
SLICKMSG.HDR 114 byte records
FIELD Description Variable Size Notes:
__________________________________________________________________________
Message From MF1$ 30 bytes
Message To MT1$ 30 bytes
Message Date MD1$ 10 bytes
Message Time MTI1$ 8 bytes
Message Conference # MC$ 2 bytes private, deleted, read
Message Subject MS1$ 30 bytes
Message REF Number MR$ 2 bytes
Message Security Level MSEC$ 2 bytes
*****************************************************************************
SLICKMSG.DAT 80 byte records
__________________________________________________________________________
Data of message D$ 80 bytes
*****************************************************************************
SLICKLOG.DAT
Sample Content Variable Description
WAITING FIRSTCALL ----->A1$ --------->Users Full Name
00:02:45 ----->A2$ --------->Logon Time
00:02:45 ----->A3$ --------->LogOff Time
GARY RAYMOND
15:30:17
15:31:36
JOHN DOE
15:31:43
15:35:30
*****************************************************************************
SLICKBUL.DAT
__________________________________________________________________________
MENU of All BULLETINS
BULLMENU.BUL
11-07-89
1000
HOW to USE SBBS
USESBBS.BUL
11-07-89
1000
BAY AREA SIG MEETINGS
SIG.BUL
10-18-1989
1000
*****************************************************************************
JOKES.TXT Ascii Text File containing about 150 witty quotes you
add or delete from at will.
BO$(BO) Array variable used by SBBS to Load Jokes.
*****************************************************************************
YOUR MODEM:
More than 90% of the calls we receive requesting help turn out to be Modem
configuration problems. SBBS sends the following string to your modem at
runtime. "ATH0M1V0&C1&D2S0=1S2=128" The explanation is as follows, and as
most modern modems respond to these commands, you should have no problems.
But, if you happen to have an oddball piece of hardware, this explanation
might help solve your setup problems.
AT Hayes modem ATTENTION command....more is comming
HO Put the line ON-HooK and prepare to receive calls
M1 Leave the speaker ON until Data begins to move
* V0 Give NUMERIC result codes instead of Verbal (verrry important)
* &C1 Make Carrier Detect go high in presence of Carrier (verrry impt too)
* $D2 Make Modem assume Command state when DTR goes low (verry impt too)
* S0=1 Answer on FIRST ring
S2=128 Set ESCAPE CODE character out of reach by disabling
NOTE: The items with the star must be set one way or another to insure
proper BBS operation. If your modem cannot be set either by dip
switches or by AT commands to these values, the sucessful outcome
of your BBS is in serious doubt.
If your modem does not support numeric results codes, the source
code of SBBS could be easily modified to accept verbal responses.
It's just not as accurate.
DISCLAIMER
THIS PROGRAM IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE. THE AUTHOR WILL NOT BE LIABLE TO USERS
OF THIS PROGRAM FOR ANY DAMAGES, INCLUDING LOST PROFITS OR
LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES,
ARISING OUT OF USE OF THIS PROGRAM.
HISTORY
12/20/1989 SBBS V.4.2 Maintenance Release
A number of reports about eratic operation on older PC XT's running
at 4.77 were isolated to timing problems in the serial port coding.
Also a bug was reported in the message section (that has also been
swatted) that caused a lockup ocasionally when replying to private
mail.
01/10/1990 SBBS V.4.4 Maintenance Release
Several cosmetic changes in the various mini menus. Corrected several
prompts working only on uppercase responses.
03/10/1990 SBBS V.4.5 New Release New Features
Many new features (all covered in the text above) have been added
to the system. Several cosmetic changes to the Bulletin Department,
the addition of a new optional text file (TODAY.TXT) sent (if present)
to the logon, a new Read Text utility in the Files Department for
viewing text files on screen from the file directory. BUT, the most
important new feature, based on the spirit of shareware, is a MODEM
configuration file to enable any baud rate, com1 or com2 port,
pariety, databits, stopbits and modem init. string. Many potential
users either had the wrong baud modem or unavailable comm port or
both. This will give those budding sysops the ability to evaluate
the BBS on their own computer.
THE END